home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / gfx / jcosub24.lha / JACOsub / scripts / demo.js next >
Text File  |  1995-08-08  |  13KB  |  250 lines
  1. # Demonstration script for JACOsub video titling software.
  2.  
  3. # You might want to print out a hard copy of this script, and refer to it
  4. # while you play the script in Step Mode.
  5.  
  6. # This script demonstrates the flexibility of the JACOsub file format,
  7. # going through nearly all of the features available.  Don't be alarmed
  8. # by the size; this script consists mostly of comments.  The running time
  9. # is less than 90 seconds.
  10.  
  11. # You can load TurboTitle, Generic, and Arizona Anime Society format
  12. # scripts directly into JACOsub, which will automatically convert them
  13. # to JACOsub format.  However, for these and other formats (such as
  14. # Panimator) you should convert them using Jconvert before loading them
  15. # into JACOsub to correct bad time-overlaps in those scripts.
  16.  
  17. # Now let's begin.  All the directives and commands demonstrated in this
  18. # script are shown in UPPERCASE the first time they are used.
  19.  
  20.   # First, let's set up some defaults.  Time units default to SMPTE
  21.   # (1/30 second) units.  We'll use 1/100 seconds because it's simpler to
  22.   # understand for now.
  23.   # Note: All # commands may be specified by a single letter.  For example,
  24.   # below we could use #T instead of #TIMERES.
  25.  
  26. #TIMERES 100
  27.  
  28.   # Next, suppose this script consisted of subtitles played against a
  29.   # foreign film, and we noticed that the time events were drifting so that
  30.   # by the end of the script, the subtitles were occurring 2.2 seconds too
  31.   # soon.  This means we need to stretch the script's total running time
  32.   # by 2.2 seconds to correct the drift.  The #Ramp command does this.  The
  33.   # number past the decimal point is time units (in 1/100 seconds as
  34.   # specified by the #T command above), not fractions of a second.
  35.  
  36. #RAMP 2.20
  37.  
  38.   # Set font 3 for using near the end of this script, where we demonstrate
  39.   # outlining and shadowing of mono-color fonts.  JACOsub.font 18 is a
  40.   # mono-color mono-spaced font.  (This font is the one normally used for
  41.   # displaying JACOsub's running clock.)
  42.  
  43. #FONT 3 JACOsub.font 18
  44.  
  45.   # Let's change some default colors while we're at it....
  46.  
  47. #P1  0 14 14     (set "slow text" color 1 of primary palette to cyan)
  48. #p3 14  0  0  1  (set color 3 of palette 1 to red)
  49.  
  50.   # Now we will start with the list of timed lines.  Each timed line has
  51.   # the format
  52.   # <start time> <stop time> <directive> <text>
  53.  
  54.   # Just for the fun of it, let's load in an IFF file to serve as a
  55.   # backdrop for the first few titles, for the first 9 seconds.
  56.  
  57. 0:00:00.00 0:00.09.00 IL JACO.bbm 0 0 {logo will be centered on the screen}
  58.  
  59.   # Now, show an introductory title centered on the screen for 4 seconds.
  60.   # This title demonstrates the newline escape character, or manual
  61.   # wordwrap.  The new substrings created will also be word-wrapped
  62.   # automatically if they don't fit within the default width limits.
  63.   # You can also turn a title's wordwrapping off, with the W0 directive.
  64.  
  65.   # Notice also that the concatenation escape code (the \ at the end of
  66.   # each line) is NOT the same as a newline in your text.  The ending \
  67.   # character means to assume that the next line is a continuous part of
  68.   # the current one.  It works even if you split a word into two pieces.
  69.   # Concatenation ignores all space after the \ and all space before the
  70.   # first character on the line that follows the \.
  71.  
  72. 0:00:00.00 0:00:04.00 VM JACOsub\n\nThis script demonstrates \
  73.                          some of the capabilities of JACOsub.
  74.  
  75.   # The next 3 lines demonstrate vertical positioning and overlapping time
  76.   # ranges.  Notice how the times for each of the lines are set.  All three
  77.   # lines are present on the screen only between times 6.00 and 6.50.
  78.  
  79. 0:00:04.00 0:00:06.50 VT Text may be positioned at the top,
  80. 0:00:05.00 0:00:07.10 vm middle,
  81. 0:00:06.00 0:00:07.70 VB or bottom of the screen.
  82.  
  83.   # The next line shows how you can insert comments inside the text.  This
  84.   # is useful for making notes about translations and character names when
  85.   # subtitling foreign films.  Here we also demonstrate how Italics (\I)
  86.   # and Normal (\N) escape codes can be embedded in the title text.
  87.  
  88. 0:00:08.00 0:00:11.00 vm {this is a comment} (And, you just saw, {another \
  89.                          comment} timing ranges for different lines of \
  90.                          text \Iand\N graphics may overlap.)
  91.  
  92.   # Here we demonstrate that graphics can overlap titles in time.
  93.  
  94. 0:00:9.50 0:00:12.60 il JACO.bbm 25 25    {place logo lower right}
  95.  
  96.   # Now we demonstrate left/right/center justification
  97.  
  98. 0:00:11.00 0:00:13.50 JL Within margin constraints\n\
  99.                          that you set, text may be\nleft justified,
  100. 0:00:13.50 0:00:14.75 JC {the JC is redundant - it's the default}\
  101.                          center\njustified,
  102. 0:00:14.75 0:00:16.00 JR and also\nright justified.
  103.  
  104.   # Here we show what you can do with margin settings.  The first line
  105.   # sets the right margin to 33% of the screen (left margin is at 1%), and
  106.   # the second line sets the left margin at 40% of the screen (right
  107.   # margin is at 99%).  We also demonstrate two fonts on the same screen,
  108.   # and full justification using the JF:L directive.
  109.  
  110. 0:00:15.60 0:00:22.00 vtHR33   It's possible, for example, to set margins \
  111.                so that text is confined to the left 1/3 of the screen.
  112. 0:00:17.50 0:00:22.00 vbHL40F1JF:L And you can place other text elsewhere \
  113.          (with a different font, if desired) by setting different \
  114.          margins for it.  As you can see here, the left and right edges \
  115.          of a text block can be aligned automatically, also.
  116.  
  117.   # Now we demonstrate different text styles and colors.  Notice here we
  118.   # use the VL directive to position the text on different lines.  The
  119.   # position of the "line number" after the VL depends on font height.
  120.  
  121. 0:00:22.30 0:00:27.50 VL3 Text may appear in different styles\n(Normal, \BBold, \IItalic\N)
  122. 0:00:22.30 0:00:27.50 vl5 and different \C1colors
  123.                       # Notice here the default text color has been
  124.                       # changed to 1 and restored to 3 inside the text.
  125. 0:00:24.00 0:00:27.50 CF1vl7 all \C3mixed \C1\Itogether.
  126.  
  127.   # On the same screen, demonstrate loading in a different color palette
  128.   # so that another color appears (color 3=red as defined in Palette 1).
  129.  
  130. 0:00:25.00 0:00:27.50 CP1vl8 (even with different palettes.)
  131.  
  132.   # Demonstrate the JF:U directive (Unconditional Full Justification)
  133.   # by displaying some examples of movie credits.  The credits are
  134.   # written to be approximately the right length, and the JF:U directive
  135.   # does the rest of the work, adjusting the spaces so the left and
  136.   # right edges are flush with the current margins.
  137.   # Note also that the VM directive would normally center the block of
  138.   # credits on the screen, but here we use VM1 to shift the centered
  139.   # block down 1 line.
  140.  
  141. 0:00:27.50 0:00:32.00 vtcf1 {description} ``Unconditional'' justification is useful for credits:
  142. 0:00:27.50 0:00:32.00 vm1f1JF:U {show credits in various styles}\
  143.       Clint Eastwood . . . . . . . Dirty Harry\n\
  144.       Michael J. Fox . . . . . . Clint Eastwood\n\n\
  145.       Madonna - - - - - - - - - - - Herself\n\
  146.       Eddie Murphy - - - - - - - - Axel Foley\n\n\
  147.       George Lucas --------------------- Director
  148.  
  149.   # Here's a trick.  We will rapidly cycle through some blank screens
  150.   # so that the current display will "catch up" to the background display
  151.   # buffer being generated.  We use color 1 text here, which is slow.
  152.   # The title directive doesn't matter for these rapid blanks, so we
  153.   # will use the program default (D) here.  The default typically
  154.   # positions a title at the bottom center of the display, using margins
  155.   # at the left and right edges (1% and 99%), auto-wordwrap, font 0,
  156.   # color 3, etc.  You may change the default behavior with the #D or
  157.   # #D0 command.
  158.  
  159. 0:00:32.00 0:00:32.02 D ~
  160. 0:00:32.02 0:00:32.04 d ~
  161. 0:00:32.04 0:00:32.06 d ~
  162. 0:00:32.06 0:00:32.08 d ~
  163.  
  164.   # But before we show catching up to the generating buffer, just for
  165.   # fun, let's define directive D2 as CF1VM to use in the next line, for
  166.   # "Color Fontface 1, Vertical position Middle."
  167.  
  168. #D2 CF1VM
  169.  
  170. 0:00:32.10 0:00:36.00 D2 Here the display was intentionally ``caught \
  171.                up'' to the background generation, to show how slowly \
  172.                color 1 text is generated in the background.
  173.  
  174.   # In the next title, lots of things happen at once.  We demonstrate
  175.   # Three things: block justification with word justification, the vertical
  176.   # continuation directive, and background shading.
  177.  
  178.   # The first title after this comment demonstrates the JB (Justify Block)
  179.   # directive.  Text is left-justified, but it is not positioned flush with
  180.   # the left margin - the block of text is centered on the screen (JBC) but
  181.   # the first character of each line are flush left.  In other words, the
  182.   # JL means "left justify" but JBC means "center the block of text."
  183.  
  184.   # The next title demonstrates the VU directive to show how you can
  185.   # continue a long line of text underneath previous ones.
  186.   # Here we also demonstrates background shading -- a semi-transparent
  187.   # rectangle will appear behind the text, 8 pixels larger than the text
  188.   # all around, using the directive CS8.
  189.  
  190. 0:00:36.30 0:00:47.00 d2jlJBC \
  191.    You will see that sort of foreground generation if you use a lot of \
  192.    ``slow'' color 1 text.\n\C3(Color 3 text is very fast.)
  193. 0:00:36.30 0:00:47.00 VUcf1CS8 \n\n\Plan your timings so the display won't catch up to the view being generated in the background.
  194.  
  195.   # Demonstrate backgrounds that are opaque to the genlock, by specifying
  196.   # a background color.  This will clear the whole screen to that color
  197.   # before any text is drawn on it, and before any IFF files are overlaid
  198.   # onto it.
  199.  
  200. 0:00:47.00 0:00:54.00 CB1vm You can change the screen background color, too.\
  201. \n\nThis is useful if you want to make an opaque screen when using a genlock.
  202.  
  203.   # Demonstrate the #Include command.
  204.   # The VH and CSL directives are demonstrated in the #included script.
  205.  
  206. #I 0:00:54.00 idemo  # include another script, offset by 50 seconds
  207.  
  208.   # Outlining and shadowing.  The first and second lines show outlining
  209.   # a mono-color font.  The third line demonstrates font shadow generation.
  210.   # The shadow extends to the southwest (lower left).  The fourth line
  211.   # demonstrates both outlining and shadowing (to the southeast).  We use
  212.   # font 3 for all these four lines (font 3 was set to JACOsub.font 18 in
  213.   # the beginning of this script).
  214.  
  215. 0:01:02.00 0:01:09.00 FO2f3vm JACOsub can also generate outlines of any thickness around normal mono-colored fonts,
  216. 0:01:02.00 0:01:09.00 fo3f3vu as you can see here.
  217. 0:01:02.00 0:01:09.00 FSSW4f3vu    \nAlso, dropshadows in any of 8 directions are possible,
  218. 0:01:02.00 0:01:09.00 fsSE3fo2f3vu \nand outlines and shadows may be combined.
  219.  
  220.   # Demonstrate clock pausing.  This is useful for creating
  221.   # a single script to handle multiple sides of a laserdisc.
  222.  
  223. 0:01:09.00 0:01:10.00 vm Right now the clock is paused (you can see this \
  224.                          if you play the script using the clock display).\n
  225. 0:01:09.00 0:01:10.00 vuf1cf1 Press any key to continue playing, or ESC to abort.
  226. #CLOCKPAUSE 0:01:09.00
  227.  
  228.   # Show the last screen.  We'll use the alternate frame-count format for
  229.   # the start and stop times.  For this script, there are 100 counts per
  230.   # second.  Normally this format would be used when the time resolution
  231.   # is 30 per second (which would have been the default if #T100 wasn't
  232.   # specified at the beginning of the script).
  233.   # The times below correspond to 0:01:10.00 and 0:01:15.00.
  234.  
  235.   # One last vertical directive to demonstrate: VA.  This is the opposite
  236.   # of VU.  It causes a title to appear immediately Above the previous
  237.   # title.  In the case below, the second title will appear above the
  238.   # first.  The same effect can be achieved by reversing the order of the
  239.   # lines, and using VM for the first directive and VU for the second.
  240.  
  241. @0007000 @0007500 vm \n\nAt that time, you may press any key to return to the Editor.
  242. @0007000 @0007500 VA OK, this script will be finished when the screen goes blank.
  243.  
  244. # You probably noticed that most of the lines above used the VM (Vertical
  245. # Middle) directive.  We could have made this the default, by specifying
  246. # the global command #DVM near the beginning of the file.  Then we
  247. # wouldn't have had to specify VM on each line, but we would have had to
  248. # specify VB (the former default) for those lines positioned at the bottom
  249. # of the screen.
  250.